home *** CD-ROM | disk | FTP | other *** search
/ The Apple Sales & Marketi…urce Library 1999 August / Resource Library August 99.toast / mac / AppleShare IP 6.2 (NFR) / AppleShare IP 6.2 Install / AppleShare Client / International Folder / Portuguese / DHX UAM Read Me < prev   
Text File  |  1999-04-16  |  3KB  |  67 lines

  1. DHX User Authentication Module 1.0 Read Me
  2.  
  3.  
  4. CONTENTS
  5.  
  6. Introduction
  7. Requirements for Running the DHX UAM 1.0
  8. Installing the DHX UAM 1.0
  9. Using the DHX UAM 1.0
  10. Algorithms used
  11. Known Incompatibilities and Limitations
  12.  
  13.  
  14. Introduction
  15. The DHX (Diffie-Hellman Exchange) UAM provides a relativly secure way to transport cleartext passwords of up to 64 characters to the server for further processing.
  16.  
  17. Requirements for Running the DHX UAM 1.0 
  18.  
  19. •  AppleShare Client:  3.8.1 or later
  20.  
  21.  
  22. Installing the DHX UAM 1.0 
  23.  
  24. The UAM should be placed in a folder titled "AppleShare Folder" within the extensions folder on the current System Folder. No reboot is needed, though you must close the Chooser & Network Browser and reopen them before the new UAM will be noticed.
  25.  
  26. Using the DHX UAM 1.0 
  27. If the server you are connecting to, supports the DHX UAM, the AppleShare Client will put up a dialog allwing you to choose "Encrypted Password" as a login mechanism. Select this UAM and fill in your password and username just as you would for the standard AppleShare login dialog.
  28.  
  29. Algorithms Used
  30.  
  31. password is padded with nulls to 64 bytes
  32. username is a pstring, padded to even byte length (odd number of chars)
  33. ServerSig is obtained from the AFPSrvrInfo reply from the server.
  34.  
  35. first message from client to server:
  36. | login (2 bytes)  | AFP Vers | UAMName "DHCAST128" | Username (padded) | Ma (16 bytes) |
  37.  
  38. reply (server to client)
  39. | ID (2 bytes) | Mb (16 bytes) | (16 byte nonce, ServerSig)K |
  40.  
  41. login continue (client to server)
  42. | logincontinue (2 bytes) | ID (2 bytes) | (16 byte nonce + 1, password)K |
  43.  
  44. reply (server to client)
  45. pass / fail
  46.  
  47. (data)K = Encrypt data using CAST 128 CBC with key = K
  48.  
  49. The Key is generated with a Diffie-Hellman key exchange as follows:
  50. Ma - first message = g^Ra mod p  (sent by the Client to the Server)
  51. Mb - second message = g^Rb mod p (sent by the Server to the Cleint)
  52. K - Key = Mb^Ra mod p = Ma^Rb mod p
  53.  
  54. We are using CAST 128, (the implementation from SSLeay) in CBC mode with the IV in the second message being the bytestring "CJalbert" and the IV in the third message being the bytestring "LWallace".
  55.  
  56. Known Incompatibilities and Limitations
  57.  
  58. • There seems to be a problem between Norton Antivirus and the DHX UAM. The client mac will crash with an illegal instruction when the user types into the username or password fields. Workaround is to turn off Norton Antivirus.
  59.  
  60.  
  61.  
  62.  
  63. © 1999 Apple Computer, Inc. All rights reserved. Apple, the Apple logo, AppleShare, AppleTalk, HyperCard, LocalTalk, Mac, Macintosh, MacTCP, and PowerBook are trademarks of Apple Computer, Inc., registered in the United States and other countries. PowerPC is a trademark of International Business Machines Corporation, used under license therefrom.
  64. The CAST implementation was written by   Eric Young (eay@cryptsoft.com) for SSLeay.
  65. The bignum routines were written by Wei Dai for cryptlib.
  66.